home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / gfxapps / pbmpl91d / pbmplus / man / pnmrotat.man < prev    next >
Text File  |  1993-01-08  |  2KB  |  69 lines
  1.  
  2.  
  3. pnmrotate(1)               Unix Programmer's Manual               pnmrotate(1)
  4.  
  5.  
  6. NAME
  7.      pnmrotate - rotate a portable anymap by some angle
  8.  
  9. SYNOPSIS
  10.      pnmrotate [-noantialias] angle [pnmfile]
  11.                               -----  -------
  12.  
  13. DESCRIPTION
  14.      Reads a portable anymap as input.  Rotates it by the specified angle  and
  15.      produces a portable anymap as output.  If the input file is in color, the
  16.      output will be too, otherwise it will be  grayscale.   The  angle  is  in
  17.      degrees   (floating   point),  measured  counter-clockwise.   It  can  be
  18.      negative, but it should be between  -90  and  90.   Also,  for  rotations
  19.      greater  than  45  degrees  you  may  get better results if you first use
  20.      pnmflip to do a 90 degree  rotation  and  then  pnmrotate  less  than  45
  21.      -------                                         ---------
  22.      degrees back the other direction
  23.  
  24.      The rotation algorithm is Alan Paeth's three-shear method.  Each shear is
  25.      implemented  by looping over the source pixels and distributing fractions
  26.      to each of the destination pixels.  This has an "anti-aliasing" effect  -
  27.      it  avoids  jagged  edges  and similar artifacts.  However, it also means
  28.      that the original colors or gray levels in the image  are  modified.   If
  29.      you  need  to  keep  precisely  the  same  set of colors, you can use the
  30.      -noantialias flag.  This does  the  shearing  by  moving  pixels  without
  31.      changing  their  values.   If you want anti-aliasing and don't care about
  32.      the precise colors, but still need a limited *number* of colors, you  can
  33.      run the result through ppmquant.
  34.                             --------
  35.  
  36.      All flags can be abbreviated to their shortest unique prefix.
  37.  
  38. REFERENCES
  39.      "A Fast Algorithm for General Raster Rotation" by  Alan  Paeth,  Graphics
  40.      Interface '86, pp. 77-81.
  41.  
  42. SEE ALSO
  43.      pnmshear(1), pnmflip(1), pnm(5), ppmquant(1)
  44.  
  45. AUTHOR
  46.      Copyright (C) 1989, 1991 by Jef Poskanzer.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                12 January 1991                               1
  68.  
  69.